home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1999 May / macformat-076.iso / Demos / Koan Pro Demo / Read Me - Macintosh Specific < prev   
Encoding:
Text File  |  1998-09-29  |  8.9 KB  |  173 lines  |  [TEXT/ttxt]
  1. =============================================================================
  2. README.TXT for SSEYO Koan Pro V2.1 - Macintosh Version       1st October 1998
  3. =============================================================================
  4.  
  5. =============================================================================
  6. Note - SSEYO Koan Pro and the accompanying information are copyright materials
  7.        of SSEYO Ltd. Be sure that you agree to the license terms that
  8.        accompany this product, before using the software !
  9. =============================================================================
  10.  
  11. A Bit of Background
  12. -------------------
  13.  
  14. The project to port Koan Pro to the Apple Mac platform was in response to
  15. considerable demand from Mac fans ! We started things off at the end of May
  16. 1998, and were up-to-speed by the end of June. The first Beta release came
  17. in mid August, with a final release date of 1st October 1998.  We really hope you
  18. appreciate our efforts, and like the product : and do please be sure to let
  19. your friends know about it !
  20.  
  21. Details
  22. -------
  23.  
  24. 1. Requirement : Power Mac with MacOS 7 or later. MacOS 7.5 or later
  25.    recommended.  SSEYO's Koan software is not available for 680x0 Macs.
  26.  
  27. 2. Requirement : The programs require at *least* 5 Megabytes of free memory in
  28.    which to run.
  29.  
  30. 3. Requirement : To install the software, you'll need to have Aladdin Systems'
  31.    StuffIt expander installed on your Mac. You can get this from :
  32.    http://www.aladdinsys.com.
  33.  
  34. 4. Requirement : Koan for the Power Mac requires OMS from Opcode systems
  35.    (http://www.opcode.com).  Be sure to install at least the freely
  36.    downloadable OMS Lite, before running your Koan software !
  37.  
  38. 5. Requirement : To view the manual, which comes in pdf format, you will
  39.    require the freely-downloadable Adobe Acrobat reader from
  40.    http://www.adobe.com.
  41.  
  42. 6. Optional : If you can't afford a synthesizer, install Apple's freely
  43.    downloadable Quick Time Musical Instruments (QTMI) before installing OMS !
  44.    (http://quicktime.apple.com, or http://www.apple.com).
  45.    Note that QTMI is included with the latest version of QuickTime, 3.02 at
  46.    the time of writing.
  47.  
  48. 7. Note : Some features of Koan Pro for Windows are not implemented. These
  49.    include :
  50.    - No on-line help system : instead, we use a PDF version of the Koan Pro
  51.      manual. Note that this is for the Windows version of Koan Pro, which
  52.      is almost identical to the Mac version.
  53.    - SoundFont support (only available for certain soundcards under Windows)
  54.    - WAV file playback and recording
  55.    - Special Direct X features (only available for Windows)
  56.    - Multithreaded composer (MacOS is currently not multithreaded)
  57.    - Fine-tuning of the high priority conductor timer settings
  58.    - There is no template list maintenance from the Mac -
  59.      if you want a file to be in the list of templates available to you when
  60.      you select File | New, then simply copy them to your TEMPLATE directory.
  61.    - Keyboard accelerators are different : mostly, they match, using the
  62.     "cmnd" key where the Windows version uses the Control key. To find out
  63.     what the accelerators are, have a look at the Menu (they are listed
  64.     alongside each option !).
  65.  
  66.    Note that in Koan Pro for Power Mac, the AWE controllers (PC specific) are
  67.    still displayed and editable, even though they have no audible effect on the
  68.    Mac. The reason for this is to ensure a consistent user interface across
  69.    both our PC and Mac products.
  70.  
  71. 8. Note : Graphics performance for Koan Pro on the Mac is noticeably slower to
  72.    our eyes than on a dollar-equivalent PC. The primary reason for this is that
  73.    the cross-platform development tool we have used to help achieve the port,
  74.    does a good job but doesn't give absolute best GUI performance. We think
  75.    that this is somewhat tunable, by writing a lot more totally Mac-specific
  76.    display code, but we wont't be able to justify the expense of this unless
  77.    we get the sales to justify ! So if you want to speed things up, please
  78.    do your best to promote SSEYO to your friends and colleagues ! :-)
  79.  
  80. 9. Note : You prefences are stored in your Mac's Preferences folder (which is
  81.    in turn in your System folder), in files like SSEYO.INI, KPRO32.INI and
  82.    KPRO32D.INI. These files are directly viewable with your favourite text
  83.    editor : but please don't modify yourself, unless explicity asked to by
  84.    SSEYO Technical support staff !
  85.  
  86. 10.Note : All SSEYO Koan files (SKD, SKT, SKP) work just fine with Windows
  87.    versions of the SSEYO Koan software (and vice-verca). If you transfer a file
  88.    from the PC to the Mac, and can't see the file when trying to open the file
  89.    from Koan Pro (using File | Open), then this is because the file comes across
  90.    without a file type resource. To open the file, simply change the file type
  91.    list to "All Files" : all file types will be shown : you can then open the
  92.    transferred file. If you re-save the file on the Mac, then the file will be
  93.    visible by default if you try to re-open the file.
  94.  
  95. 11.Tip : Save your Koan files with either ".skd" or ".skt" file extensions.
  96.    This will make it far easier to exchange your files with PC users, and is
  97.    also essential for playing your files over the Internet !
  98.  
  99. =============================================================================
  100. Problems ? Check out the Koan Mac trouble-shooter FAQ !
  101. =============================================================================
  102.  
  103. Q: OMS is installed and it sees quicktime instruments, but no sound comes
  104.    out of Koan (except for a low frequency drone). What should I check to
  105.    see that everything is hooked up right? Actually in OMS, although it sees
  106.    QT musical instruments, there is red international "no" symbol drawn on top
  107.    of it. Perhaps I have not turned something on somewhere?
  108. A: By default with OMS the QuickTime musical instruments are off !
  109.    If the icon in the application "OMS Setup" is a red circle with a line
  110.    through it then you need to enable QT musical instruments.
  111.    If you double-click the crossed QT icon in your OMS setup, a new window
  112.    appears which gives the option to turn QT on/off. You should select 'on' to
  113.    use QT as an active synthesiser.
  114.  
  115.    You can also use the keystrokes cmnd+t to test the connection, i.e. press
  116.    the apple key and 't' together, the cursor changes to a quaver and you
  117.    basically click the quaver over the synthesiser (OMS will make an audible
  118.    verification of a successful connection); if you have a dummy keyboard,
  119.    you can simply press some keys on the controller (while in test mode) and
  120.    OMS will tell you if midi was received.
  121.  
  122.    Alternatively, select the icon next to QuickTime musical instruments and
  123.    choose "Midi device info..." from the studio menu, a modal dialog will
  124.    appear called "Configue QuickTime synth".  Click the radio button next to
  125.    "on" to enable.  Click OK to dismiss the dialog.
  126.  
  127. Q: How do I set-up my MIDI controller with OMS, to play using Listening voices ?
  128. A: Setup of external devices with OMS is beyond the scope of this README file !
  129.    Refer to the documentation that came with your keyboard, to see how
  130.    to configure this with OMS.
  131.  
  132. Q: What do I do if the Koan Pro splash screen hangs ?
  133. A: This is due to an intermittent Mac-specific bug we haven't tracked down yet.
  134.    If this happens, then just jiggle the mouse around, it will disappear in a
  135.    few seconds.
  136.  
  137. Q: What do I have to do with the extension OMSLibPPC.slb ?
  138. A: This file just sits there, as a kind of glue around the OMS services.
  139.    There is nothing you have to do with it!
  140.  
  141. Q: What versions has this software been tested on ?
  142. A: Mac OS 7.5, 8.0, 8.5, OMS 2.31, QuickTime 3.0, etc. etc., Power Mac Quadra,
  143.    Power Computer, Power Mac 9600, PowerBooks etc. etc. We've tried to cover
  144.    pretty much everything !
  145.  
  146. Q: What is up with the dark selector box, which occasionally displays oddly ?
  147. A: This is due to some odd generic display bugs, which are not fatal ! If they
  148.    ever appear and you want to get rid of them, simply hide the window and
  149.    redisplay.
  150.  
  151. Q: When playing-back with QuickTime musical instruments : it can take a short
  152.    while for the instrument settings to change (e.g. might start with Piano,
  153.    and then change to my selected patch after a couple of seconds).
  154.    Why is this ?
  155. A: This appears in some way to be due to QT's implementation : engineers at
  156.    Apple are aware of this problem.
  157.  
  158. Q: I really like this product ! How can I help to publicise it ?
  159. A: Please feel free to spread the word to your friends, by any methods
  160.    you can think of (talking, e-mail, newsgroups, carrier-pigeon ...) :)
  161.    SSEYO depends on your goodwill and publicity !
  162.  
  163. =============================================================================
  164. Please refer to the Generic Koan Pro readme file for further information !
  165. =============================================================================
  166.  
  167. Special thanks to the following Mac fans who helped us to get our facts
  168. straight in this FAQ :-) :
  169. - Dave Murphy
  170. - Sam Dewitt
  171. - Joseph McLean
  172. - Marko Tandefelt
  173.